home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / tools / pcfmt.com / PCFMTDOC.COM (.txt) < prev    next >
Encoding:
Graham's TXT2COM  |  1989-06-14  |  12.3 KB  |  200 lines
  1. ~0E
  2.                       ┌─────────────┐ ┌────────────┐┌─┐
  3.                       └┐           ┌┘ │    ┌──────┐└┘ │
  4.                        │           │  │    │      └───┘
  5.                        │           │  │    │          <tm>
  6.                        │           │  │    └─────────────┐
  7.                        │           │  └──────┐           │
  8.                        │           │         │           │
  9.                        │           │         │           │
  10.                        │           └─────────┘           │
  11.                        │  U n i q u e   S o f t w a r e  │
  12.                        └─────────────────────────────────┘                   ~02
  13.                PCFMT 1.2 Copyright (c) 1988-89 by Unique Software            ~0F
  14.                  Full documentation and License for only $15.00              ~07
  15.                   (+$2 for 3.5"-720K disks if needed/requested)              ~02
  16.                                  Unique Software 
  17.                              Post Office Box 26613 
  18.                           Fort Worth, Texas 76126-0613 
  19.  CompuServe : 70130,330  :: MCI-Mail : 252-8689 :: Am. People Link : UNIQUESOFT 
  20.                      ~87365~07 day - ~8724~07 hour FAX line : 1-817-249-4284             ~0A
  21.  
  22.                           -Press [PG DN] for next page-                      ~03
  23.  
  24.  
  25. ~0F                                    ~03   This program  is  produced by a member of 
  26. ~0F                                    ~03the  Association of Shareware  Professionals 
  27. ~0F                                    ~03(ASP).    ASP  wants to make sure  that  the 
  28. ~0F       ┌─────────┐      <tm>        ~03shareware principle works for  you.  If  you 
  29. ~0F ┌─────┴───┐     │                  ~03are  unable  to resolve a  shareware-related 
  30. ~0F─│         │o    │───────────────── ~03problem with an ASP member by contacting the 
  31. ~0F │   ┌─────┴╨──┐ │  Association of  ~03member  directly,  ASP may be able to  help. 
  32. ~0F │   │         │─┘  Shareware       ~03The  ASP  Ombudsman  can help you resolve  a 
  33. ~0F └───│    o    │    Professionals   ~03dispute  or problem with an ASP member,  but 
  34. ~0F─────│    ║    │─────────────────── ~03does  not  provide  technical  support   for 
  35. ~0F     └────╨────┘    MEMBER          ~03members'  products.  Please write to the ASP 
  36. ~0F                                    ~03Ombudsman  at P.O.  Box 5786,  Bellevue,  WA 
  37. ~0F                                    ~0398006   or  send a  Compuserve  message  via 
  38. ~0F                                    ~03easyplex to ASP Ombudsman 70007,3536     ~02
  39.  
  40.     You should  inspect the file with the extension ".LST"  for a  list  of  the 
  41. programs which SHOULD be contained in this package and their size.           ~0A 
  42.  
  43.  
  44.                           -Press [PG DN] for next page-                      ~02
  45.  
  46.     Vendors,   User  Groups,   and  Schools must read the  file  VENDOR.DOC  for 
  47. important information relating to their use and distribution of this program.~03 
  48.     Shareware is  NOT mediocre  software  because it's inexpensive.  It has been 
  49. accurately estimated that research and development costs (programming) in a $500 
  50. program  package are less than $50.  You see, with Shareware you are  NOT PAYING 
  51. for fancy packages, costly advertising, and expensive distribution methods.  ~02 
  52.     Shareware  is  NOT FREE.  If you "buy"  a  disk full of software for  $3.95, 
  53. $5.00,   or  $9.99  all you have paid for is the disk,  the time for making  the 
  54. collection, and shipping and handling.                                       ~03 
  55.     The  Shareware author is still legally entitled to receive compensation  for 
  56. his work. Many programmers make their  living by distributing their programs via 
  57. Shareware.  The license fee/registration which you should send is a programmer's 
  58. paycheck.                                                                    ~02 
  59.     Shareware  gives  you  get  the ULTIMATE GUARANTEE,  "If you don't  use  the 
  60. product,   you don't pay for it!".  Try getting that guarantee with "commercial" 
  61. software.                                                                    ~02 
  62.     After you have used this program for ~0A30~02  days,  you must ~0ADISCONTINUE use  OR 
  63. PURCHASE ~02a single-user LICENSE from Unique Software.                      ~0A 
  64.  
  65. ~0A
  66.                           -Press [PG DN] for next page-                      ~02
  67.  
  68.     It's EASY to become a licensed user of this program, at your DOS prompt type 
  69. `LICENSE'  and answer the questions.  Your printer does all the work.  You don't 
  70. have to write anything. You don't even need an envelope!                     ~07 
  71.     VISA/MC registration is honored by the Public Software Library (800-2424-PSL 
  72. orders - Info 713-665-7017) and you get a $5 credit with PSL for later use.  ~03 
  73.     Licensed users get printed FULL documentation (when applicable)  and receive 
  74. free  technical support for a year.  Technical questions can be submitted to any 
  75. of the onlines  services or FAX'd.  (The numbers are listed on the  HOME  page.) 
  76.    [To request techical support,  the following is required:  free memory before 
  77. running program, printer type (when applic), resident programs, and a listing of 
  78. your AUTOEXEC.BAT and CONFIG.SYS files.]                                     ~02
  79.    This  software  and documentation are distributed and/or sold  "as  is"   and 
  80. without warranties as to performance of merchantability or  any other warranties 
  81. whether  expressed  or implied.  Because of  the various hardware  and  software 
  82. environments  into  which any program may be put,  no warranty of fitness for  a 
  83. particular purpose can be offered. Good data  processing procedure dictates that 
  84. any program  be  thoroughly tested  with non-critical data before relying on it. 
  85. The user must assume the entire risk of using the program.  Any liability of the 
  86. seller will be limited exclusively to product replacement.                   ~0A
  87.  
  88.                           -Press [PG DN] for next page-
  89. ~#0~07
  90.  
  91.  
  92.                PCFMT 1.2 Copyright (c) 1988-89 by Unique Software            ~02
  93.  
  94.  
  95.  
  96.                     F1 - Description / Run Menu
  97.  
  98.  
  99.                     F2 - Options in Depth [1] & [3]
  100.  
  101.  
  102.                     F3 - Options in Depth [4] & [5]
  103.  
  104.  
  105.                     F4 - Options in Depth [7] - [9] / Running                ~07
  106.  
  107.  
  108.                    F10 - Return to THIS Menu
  109.  
  110.  
  111. ~#1~02
  112.     PCFMT formats your Aspect Source Files, accounting for all block structures, 
  113. giving you evenly indented statements which are easier to read.              ~07
  114.                                     Run Menu                                 ~03
  115.   usage: PCFMT (no options are valid)                                        ~02
  116.   PCFMT 1.2 Install - (c) Copyright 1988 by Unique Software 
  117.   [1] Extension for backup file : .BAK 
  118.   [2] Backup (original) File is to be [K]ept/[D]eleted after formatting : D 
  119.   [3] Indent width : [V]ariable / [F]ixed : V 
  120.   [4] ;remarks : [F]lush left / [I]ndented : F 
  121.   [5] Starting indention column number : 2 
  122.   [6] Labels : [F]lush left / [I]ndented : F 
  123.   [7] *Labels : [U]PPER / [l]ower / [C]apital / [N]oChange : C 
  124.   [8] *Reserved Words : [U]PPER / [l]ower / [C]apital / [N]oChange : U 
  125.   [9] *Variables : [U]PPER / [l]ower / [C]apital / [N]oChange : L 
  126.   [Q]uit Install 
  127.   [R]un with current defaults (defaults not saved) 
  128.      {Licensed users can SAVE their defaults and run from the command line}
  129.   [?] Option     * - the Fast Option [*] overrides these                     ~0C
  130.  
  131.     (NOTE:   For licensed users this is an option.  For non-licensed users,  the 
  132. Install Menu is presented each time PCFMT is run.) 
  133. ~#2~02
  134.  
  135.                                 Options in depth
  136.  
  137.  
  138.  
  139.     [1] The file extension has to contain at least ONE valid filename character.  
  140.  
  141.  
  142.  
  143.     [3]  "Indent width"  is the width each block structure keyword is  indented. 
  144. Variable indicates that the width will be determined by the keyword itself.  For 
  145. example:  
  146.  
  147.     IF SUCESS 
  148.        DEC N0 
  149.     ENDIF 
  150.     If the column tab width was set to 5, this example would look 
  151. like: 
  152.     IF SUCESS 
  153.          DEC N0 
  154.     ENDIF 
  155. ~#3~02
  156.  
  157.  
  158.     [4]  ";remarks"   is the position of single-line remarks within  the  source 
  159. code.   Flush  left indicates that all remarks will  be flush to the left.   For 
  160. example:  
  161.  
  162.  
  163.     IF WAITFOR 
  164.        TRANSMIT "Y^M" 
  165.     ; tell the bbs Yes 
  166.     WAITFOR "Files" 
  167.     If this is set to "Indented", this example would look like: 
  168.     IF WAITFOR 
  169.        TRANSMIT "Y^M" 
  170.        ; tell the bbs Yes 
  171.     WAITFOR "Files" 
  172.  
  173.  
  174.     [5] "Starting indention column number" indicates the starting default column 
  175. for a this Aspect file. This does NOT affect any items set to Flush left.  
  176.  
  177. ~#4~02
  178.  
  179.     Options 7-9, indicate the case of the item named. If we use the example word 
  180. "This_is_a_TEST" for each case the results would be:  
  181.     [U]PPER - "THIS_IS_A_TEST" 
  182.     [l]ower - "this_is_a_test" 
  183.     [C]apital - "This_Is_A_Test" 
  184.     [N]oChange - "This_is_a_TEST" 
  185.     Obviously such conversion requires quite a bit of time, PCFMT has to look at 
  186. each word in each line and determine exactly what it is and what PCFMT has to do 
  187. with it.  The formatting time of PCFMT  with any ONE of these options not set to 
  188. [N]oChange slows down formatting time by a factor of 8 to 10  for each line. 
  189.  
  190.     [R]un - run PCFMT. You will be prompted  for  a filename.   The defaults you 
  191. have specified are NOT retained by PCFMT. 
  192.  
  193.  
  194.              Turning Formatting OFF and ON inside your source code 
  195.  
  196.     Do you have a  special  way you like  a  section of code formatted but PCFMT 
  197. "messes"   it  up everytime?  The full documentation will explain  how  to  turn 
  198. formatting on and off inside your ASPECT source code. 
  199.  
  200.